home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-04 / mapper31.zip / MAPPER.DOC < prev    next >
Text File  |  1992-02-02  |  55KB  |  1,126 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                 MM   MM   IIIIII    CCCC   RRRRRR    OOOOO
  11.                 MMM MMM     II     CC  CC  RR   RR  OO   OO
  12.                 MMMMMMM     II    CC       RR   RR  OO   OO
  13.                 MM M MM     II    CC       RRRRRR   OO   OO
  14.                 MM   MM     II    CC       RR RR    OO   OO
  15.                 MM   MM     II     CC  CC  RR  RR   OO   OO
  16.                 MM   MM   IIIIII    CCCC   RR   RR   OOOOO
  17.  
  18.             MM   MM    AAA    PPPPPP   PPPPPP   EEEEEEE  RRRRRR
  19.             MMM MMM   AA AA    PP  PP   PP  PP   EE   E  RR   RR
  20.             MMMMMMM  AA   AA   PP  PP   PP  PP   EE E    RR   RR
  21.             MM M MM  AA   AA   PPPPP    PPPPP    EEEE    RRRRRR
  22.             MM   MM  AAAAAAA   PP       PP       EE E    RR RR
  23.             MM   MM  AA   AA   PP       PP       EE   E  RR  RR
  24.             MM   MM  AA   AA  PPPP     PPPP     EEEEEEE  RR   RR
  25.  
  26.  
  27.                                   Version 3.1
  28.  
  29.  
  30.                         Copyright 1990 by Mark McDonald
  31.                               All Rights Reserved
  32.  
  33.  
  34.  
  35.                           Micro-Mapper Documentation
  36.  
  37.  
  38.  
  39.   Micro-Mapper  -- Copyright 1990 by Mark McDonald -- All Rights Reserved
  40.  
  41.     Introduction
  42.  
  43.     Micro-Mapper was born of the desire to  program  smarter,  not  harder.
  44.     One of the most tedious jobs in programming  is  designing  and  coding
  45.     screens(maps).  Usually you go through several screen revisions  before
  46.     you get it just right, continually changing the code.
  47.  
  48.     With Micro-Mapper you can  now create screens for your programs without
  49.     writing code.  Just paint it the way that you  want  with  the  desired
  50.     colors and save it in one of several built-in formats, or  design  your
  51.     own format, for later use by your program.   Creating  screens  without
  52.     writing code enables you to make changes  and  experiment  without  the
  53.     pain of changing, re-compiling and testing the code.
  54.  
  55.     When you have your screen drawn, use the Map Field function  to  define
  56.     field names, sizes, types, etc.  The field definitions can then be used
  57.     by your program or by Micro-Coder to generate code to perform all input
  58.     and output from the screen.
  59.  
  60.     Micro-Coder is a code generator for ZBASIC, C, COBOL,  dBASE  and  REXX
  61.     languages(more comming, if  you  have  a  need  for  another  language,
  62.     include the request with your registration) and  may  be  purchased  by
  63.     registered users.
  64.  
  65.  
  66.     Copyright 1990, 91, 92 by Mark McDonald
  67.  
  68.     Micro-Mapper  is  the  intellectual  property  of  the   author,   Mark
  69.     McDonald, who reserves all rights.  This software is NOT public  domain
  70.     or freeware.  Sale of this program or its source code, in any form,  is
  71.     expressly forbidden without written permission of the author.  Users of
  72.     this program are allowed to evaluate it for  a  period  of  two  weeks.
  73.     After which, the user is required to  register  the  program  with  the
  74.     author to obtain a licensing agreement or discontinue its  use.   Users
  75.     are encouraged to share the original Micro-Mapper programs with   their
  76.     friends so they may try it out.
  77.  
  78.     Bulletin Boards may provide this program for downloading by  its  users
  79.     provided the programs and documentation file, as  distributed  by   the
  80.     author have not been modified or altered in any way and that no fee  is
  81.     required to download this program(other than a board membership fee).
  82.  
  83.     Shareware Distributing Houses may provide this program as long  as  the
  84.     diskette or compressed file contains only  the  original  programs  and
  85.     documentation file for this version as provided by the author and  only
  86.     a nominal distribution fee is charged.
  87.  
  88.  
  89.     Registration
  90.  
  91.     Micro-Mapper is marketed as Shareware, a system  that allows you to try
  92.     out the  software  before  purchasing  it.   You  are  allowed  to  use
  93.     Micro-Mapper for two weeks to decide its usefulness to you.   If  after
  94.     that time you find that you  desire  to  continue  using  it,  you  are
  95.     required to register your copy.
  96.  
  97.     This program required MANY hours of design and  coding.   It  would  be
  98.     appreciated if  you  would  take  the  trouble  to  register  it.   The
  99.     registration fee has been kept low to  make it  easy  to  register.   I
  100.  
  101.                                     1
  102.  
  103.   Micro-Mapper  -- Copyright 1990 by Mark McDonald -- All Rights Reserved
  104.  
  105.     understand how hard it is to buy good utilities, especially  when  they
  106.     cost $100.00+.  So I kept the price  low  and  rely  on  BBS's,  users,
  107.     etc. to distribute the program.  Shareware is for those of us who  just
  108.     don't make the mega  bucks  but  still  need  useful  utilities.   Your
  109.     support of the shareware concept makes it work.  It is up to you.
  110.  
  111.     To register your copy of  Micro-Mapper,  run RESISTER.COM or print  the
  112.     REGMAP.COM screen and fill it out, send  $15.00,  your  name,  address,
  113.     company name(if for a company), floppy size  and  Micro-Mapper  version
  114.     number to:
  115.  
  116.                              Mark McDonald
  117.                              P.O.  Box 31533
  118.                              Aurora, Colorado 80041
  119.  
  120.     You  will  be  sent  a  registered  copy  of  the  latest  version   of
  121.     Micro-Mapper if the version that you have is not the latest.   Being  a
  122.     registered owner entitles you  to  upgrades,  purchase  of  Micro-Coder
  123.     input/output  code   generators,  and announcements of new products.
  124.  
  125.     Site Licenses for Corporate,  Educational,  and  Government  users  are
  126.     available on request.  Send  your site license information  request  on
  127.     letter head to registration address.   Please  specify  exact  type  of
  128.     business and number of computers to be licensed.  Purchase  orders  are
  129.     accepted at Net 30 terms.
  130.  
  131.     Possible incentives to register:
  132.  
  133.     *Ability to purchase Micro-Coder, a  code  generator  that  compliments
  134.     Micro-Mapper generating all code needed to display and edit map fields.
  135.     A great way to do rapid prototyping and to create a program shell    to
  136.     start with or include in your application specific code.  The  cost  of
  137.     Micro-Coder is low  in  keeping  with  my  philosophy  of  making  good
  138.     software easily purchased.
  139.  
  140.     *Future enhancements for registered users will include  extended  Video
  141.     card support for EGA, MCGA, VGA and Super VGA which would allow you  to
  142.     have a bigger screen(Rows and Columns).
  143.  
  144.     *I will also be working on a 32bit version that should scream(as if  it
  145.     weren't fast enough) on 386 and 486 machines.
  146.  
  147.     *What new features or utilities do you want?  Let me know.
  148.  
  149.  
  150.     Liability Exclusion
  151.  
  152.     By using this utility, you agree  that  the  author  may  not  be  held
  153.     responsible or liable in any manner or for any reason, should  anything
  154.     happen while using or due to the use of this program.   This  includes,
  155.     but is not limited to, any  real(or  otherwise)  monetary  loss  should
  156.     unforeseen circumstances  arise  causing  data  or  productivity  loss.
  157.     Simply put, use it at your own risk.
  158.  
  159.     You also agree that you will register  one  copy  of  Micro-Mapper  per
  160.     computer that it is to be used on.
  161.  
  162.  
  163.  
  164.  
  165.                                     2
  166.  
  167.   Micro-Mapper  -- Copyright 1990 by Mark McDonald -- All Rights Reserved
  168.  
  169.     Acknowledgements
  170.  
  171.     Thanks to Hal for helping  me  proof  the  documentation  and  for  his
  172.     encouragement during the development of this utility.
  173.  
  174.     I would like to thank the many Micro-Mapper users  who have contributed
  175.     to its growth.
  176.  
  177.  
  178.     Bug Reports
  179.  
  180.     I like to  ensure  that  my  software  works,  so  if  you  do  find  a
  181.     bug, or wish to have a feature added, please feel free to write the  me
  182.     at the registration address.  You may also leave E-Mail on the NEW  AGE
  183.     SERVICES BBS, (303) 366-1106.  Include the version of Micro-Mapper that
  184.     you are using.
  185.  
  186.  
  187.     Mouse Usage
  188.  
  189.     If your mouse driver is loaded, your mouse may be used to position  the
  190.     cursor and to select menu items.   Use  of  the  mouse  tends  to  make
  191.     Micro-Mapper even easier to use.
  192.  
  193.     Pressing the right button will work the same as pressing the  ESC  key.
  194.     When in a menu, place the mouse cursor over the letter  and  press  the
  195.     left button to execute a function.  When NOT in a  menu,  pressing  the
  196.     left button will work the same as pressing the ENTER key.
  197.  
  198.     When arrows are displayed, the mouse cursor  may  be  placed  over  the
  199.     arrow and pressing or holding the left  button  will  issue  the  arrow
  200.     command.
  201.  
  202.     If a mouse is found, the cursor position information area at the bottom
  203.     left of the screen will also show the  mouse  mickeys  for  column  and
  204.     row(Handy if you want to determine mouse position of a screen item).
  205.  
  206.     Note:  A lot of people load their mouse drivers  via  the  AUTOEXEC.BAT
  207.     file.  This generally loads a COM or EXE program.  If your  mouse  came
  208.     with a MOUSE.SYS file, it is recommended that you place  the  following
  209.     statement in  your  CONFIG.SYS  file(DEVICE  =  C:\PATH\MOUSE.SYS)  and
  210.     remove the MOUSE.COM or  MOUSE.EXE  statement  from  the  AUTOEXEC.BAT.
  211.     This ensures that no matter what a program does with the mouse, it will
  212.     be available to a subsequent program.  Otherwise, a  program  may  turn
  213.     off the mouse, depriving the next executed program from using it.
  214.  
  215.     If the clicking the right mouse button causes the menu  to  appear  and
  216.     then disappear, it is due to the CPU speed of your machine.  To  adjust
  217.     the mouse delay times, change the value of the mouse delay time in  the
  218.     MAPPER.CFG file using Main Menu function O.  The default delay time  is
  219.     200(seems best for 8MHz 8088 machines.  For faster 286 machines 400  is
  220.     recommended.  For 386 and above, you need to start at 400  and  decide,
  221.     up or down, from there.
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.                                     3
  230.  
  231.   Micro-Mapper  -- Copyright 1990 by Mark McDonald -- All Rights Reserved
  232.  
  233.     Requirements
  234.  
  235.     Micro-Mapper will run on any MS/DOS(2.11 or greater version) compatible
  236.     computer system with at least 100k of free memory.  It may  be  invoked
  237.     from within your favorite editor or other programs  provided  at  least
  238.     100k of memory is free.  Micro-Mapper will run from  a  floppy,  but  a
  239.     harddrive is recommended for best performance.
  240.  
  241.     A mouse is HIGHLY recommended as cursor positioning  with  a  mouse  is
  242.     MUCH faster than with the keyboard.
  243.  
  244.     To execute the DOS window function, at least  17k  of  memory  must  be
  245.     available.  Otherwise the results may be unpredictable.
  246.  
  247.  
  248.     Installation
  249.  
  250.       For Floppy:
  251.  
  252.           1. Format a floppy diskette, with or without DOS.
  253.           2. Copy the required files to the floppy using REQ.BAT:
  254.  
  255.              REQ A: A:    Copies from a disk in Drive A (source) to a  disk
  256.                           in Drive A (destination).  Be sure  to  read  the
  257.                           prompts on the screen to determine which diskette
  258.                           to put in the drive at each  point  of  the  copy
  259.                           process.
  260.  
  261.       For Hardrive:
  262.  
  263.           1. Make a directory called MAPPER off of the root:
  264.  
  265.              MD C:\MAPPER    or   MD D:\MAPPER
  266.  
  267.           2. Copy the required files to the sub-directory using REQ.BAT:
  268.  
  269.              REQ C:\SOURCEDIR C:\MAPPER
  270.  
  271.  
  272.       REQ.BAT  will  also  create  the  batch  file  required  to  call  up
  273.       Micro-Mapper.  Be sure  to  move  this  batch  file  to  a  directory
  274.       mentioned in the PATH statement in your AUTOEXEC.BAT file(hard  drive
  275.       only).
  276.  
  277.  
  278.     The following programs must be the MAPPER directory:
  279.  
  280.       MAPPER.COM - Screen Editor.
  281.       MAPPER.MNU - Contains Menus for Micro-Mapper.
  282.       TBL.MEM    - Screen for ASCII character chart.
  283.       COLOR2.MEM - Change color screen.
  284.       COLOR1.MEM - Configuration change screen.
  285.       MAPPER.CFG - Holds your custom configuration information.
  286.       DANSI.COM  - Displays ANSI screens without having the ANSI.sys device
  287.                    driver loaded.
  288.       DWCAT3.COM - Displays screens saved in the WildCat 3 BBS format.
  289.       DMEM.COM   - Displays screens saved in the Micro-Mapper MEM format.
  290.       DASCII.COM - Displays screens saved in ASCII format(no color).
  291.  
  292.  
  293.                                     4
  294.  
  295.   Micro-Mapper  -- Copyright 1990 by Mark McDonald -- All Rights Reserved
  296.  
  297.     NOTE: DANSI.COM, DWCAT3.COM, DASCII.COM and DMEM.COM  may  be  used  as
  298.     stand alone screen displaying programs using this format:
  299.  
  300.           DANSI filename.ANS cc,rr
  301.           DWCAT3 filename.WC3 cc,rr
  302.           DMEM filesname.MEM cc,rr
  303.           DASCII filename.ASC cc,rr
  304.  
  305.  
  306.           The extension must be specified.  cc,rr are optional allowing you
  307.           to display a saved area.  When cc,rr are not present, the  screen
  308.           is cleared prior to the screen display.  If  cc,rr  are  present,
  309.           the screen is not cleared and the area is displayed  starting  at
  310.           column cc and row rr.  Subsequent lines are started at column cc.
  311.           These programs are also used by Micro Mapper to load a saved area
  312.           onto the screen.  This in effect allows  you  to  use  your  hard
  313.           drive as a scratch pad.
  314.  
  315.           NOTE: MSDOS does not properly retrieve blank lines.   This  means
  316.                 that when an ASCII area is brought in  and  placed  on  the
  317.                 screen, any blank lines are not written.  The only solution
  318.                 to this is to place a hold character as the last character.
  319.                 This is what is done for the large character sets.   It  is
  320.                 not practical for ASCII areas though  as  it  corrupts  the
  321.                 image stored.  I recommend that  the  MEM  format  be  used
  322.                 instead of ASCII in all cases.  It will save the color  and
  323.                 is the most compact of all methods.
  324.  
  325.  
  326.     Customizing Micro-Mapper
  327.  
  328.     IF MAPPER.CFG is found, Micro-Mapper will use the values found  as  the
  329.     programs defaults.  Here is how the file should look:
  330.  
  331.     7   :'Default Zap Color  NOTES:Do NOT change the number of lines.
  332.     240 :'Default MSG Color         Keep Comments for Future Reference
  333.     31  :'Default Window Color
  334.     7   :'Default Footer Color
  335.     12  :'Default Cursor Info Color
  336.     350 :'Default Mouse Delay <<---- Change value up for faster CPU's
  337.     7   :'Default Start Up Color     or mouse clicks will be too fast.
  338.     BLOCK.MCS:'Default Block character set file name.
  339.  
  340.     IF MAPPER.CFG is NOT found, the above values will be  set  as  defaults
  341.     for the session.
  342.  
  343.     You may edit the MAPPER.CFG file to suit your  needs  with  any   ASCII
  344.     editor or use the Options function on the Main Menu.  It is recommended
  345.     that you use the Options function to edit MAPPER.CFG.
  346.  
  347.     WARNING!!!!  The configuration routine is real dumb.  Change the number
  348.     of lines in the MAPPER.CFG file and you won't like the results.
  349.  
  350.     If the mouse buttons are too fast or too sluggish, change  the  default
  351.     mouse delay until it is acceptable.
  352.  
  353.  
  354.  
  355.  
  356.  
  357.                                     5
  358.  
  359.   Micro-Mapper  -- Copyright 1990 by Mark McDonald -- All Rights Reserved
  360.  
  361.     Start-Up
  362.  
  363.     To start Micro-Mapper, enter MAP and press ENTER.  Note  that  you  may
  364.     rename the batch program, MAP.BAT, as  desired  without  affecting  its
  365.     function.
  366.  
  367.     If you desire to start Micro-Mapper without  it  clearing  the  screen,
  368.     enter MAP SAVE (case does not matter).  The screen will  be  saved  and
  369.     re-displayed when the copyright information display has finished.
  370.  
  371.     Micro-Mapper automatically starts out in  what  is  called  TEXT  MODE.
  372.     There are three modes, TEXT, DRAW, and ERASE.  Each of these  modes  is
  373.     indicated as T, D or E on the status line at the bottom of the screen.
  374.     
  375.  
  376.     Screen Format
  377.  
  378.     Rows 1 through 24 are available for  screen  painting  and  only  those
  379.     lines are saved and loaded into Micro-Mapper.
  380.  
  381.     The 25th screen line is reserved for Micro-Mapper's use.   This  allows
  382.     it to display the following info:
  383.  
  384.     ccc,rr│asc│atr│MR│ff,bb│aaaaaaaaa│mccc,mrr│<<-Message Area->>
  385.      ^  ^   ^   ^  ^^  ^  ^     ^       ^   ^
  386.      |  |   |   |  ||  |  |     |       |   +--- Mouse Column in mickeys
  387.      |  |   |   |  ||  |  |     |       +------- Mouse Row in mickeys
  388.      |  |   |   |  ||  |  |     +-- ANSI Color Sequence
  389.      |  |   |   |  ||  |  +- Background Color Number
  390.      |  |   |   |  ||  +---- Foreground Color Number
  391.      |  |   |   |  |+------- Drawing Character
  392.      |  |   |   |  +-------- Mode (T=Text, D=Draw, M=Map) & current color
  393.      |  |   |   +----------- Color at cursor position
  394.      |  |   +--------------- Decimal character code
  395.      |  +------------------- Cursor Row
  396.      +---------------------- Cursor Column
  397.  
  398.  
  399.     Text Mode
  400.  
  401.     In text mode, all keyboard characters are accepted.  In  addition,  use
  402.     of the number pad(num lock on) and the alt key will enable you to enter
  403.     non-keyboardable characters, though it is easier to use  the  character
  404.     chart(X on the main menu).
  405.  
  406.     While in text mode, use the arrow keys or mouse to position the cursor.
  407.     Pressing F2 while in this mode, will cause the color under  the  cursor
  408.     to be used for any subsequent typing.
  409.  
  410.  
  411.     Main Menu
  412.  
  413.     The main menu allows access to all sub menus.   To  activate  the  menu
  414.     press the ESC key.  Pressing the ESC key again will terminate the  menu
  415.     and restore the screen.  Remember that  the  right  mouse  button  will
  416.     issue an ESC for you.
  417.  
  418.  
  419.  
  420.  
  421.                                     6
  422.  
  423.   Micro-Mapper  -- Copyright 1990 by Mark McDonald -- All Rights Reserved
  424.  
  425.     The following describes the commands available under the Main Menu;
  426.  
  427.         * Area -  allows  you   to   mark   off   an   area   and   perform
  428.           one of several functions against the area.  Press A and  you  are
  429.           prompted to position the cursor to the first corner of the  area.
  430.           Press ENTER and you are  prompted  to  move  the  cursor  to  the
  431.           second/opposing corner of the area.  Press  ENTER  and  the  Area
  432.           menu is now displayed.  Under the Area menu you may select;
  433.  
  434.           S-T C Change the  color of the area.  Press C and the   color chart
  435.             will  be  displayed.   Notice   that   all   256(0-255)   color
  436.             combinations are displayed.  The current color (that   is   the
  437.             color at the cursor position prior to invoking the menu)     is
  438.             displayed towards the bottom of  the  screen  in  brackets  [].
  439.             Pressing the U key will change the current typing color to this
  440.             color.  If you desire to use another color,  place  the  cursor
  441.             over the desired color number and press ENTER or the left mouse
  442.             button.  Any subsequent typing will now use that color.
  443.  
  444.           - F Find/Change an Attribute or Character within the area.
  445.  
  446.             - A - This function allows you to change  a  color  to  another
  447.                   color.  This is different from the Color Change option in
  448.                   that only the FROM color is changed.  When this  function
  449.                   is selected, a color  chart  is  displayed  and  you  are
  450.                   prompted to position the  cursor  over  the  color/number
  451.                   that you wish to change FROM and press  ENTER.   Now  you
  452.                   are asked to position the cursor over the TO color/number
  453.                   and again press ENTER.  All of the matching  FROM  colors
  454.                   in the area are now changed to the TO color.   Note  that
  455.                   you may press ESC prior to pressing ENTER the second time
  456.                   and you will exit the area function.
  457.  
  458.             - C - This function allows  changing  a  character  to  another
  459.                   within the  area.   When  selected,  an  ASCII  chart  is
  460.                   displayed and you are prompted to place the  cursor  over
  461.                   the FROM character and press ENTER.  Next you  are  asked
  462.                   to place the cursor over the TO character and again press
  463.                   ENTER.  All characters in  the  area  matching  the  FROM
  464.                   character are changed to the TO character.  Note that you
  465.                   may press ESC prior to pressing ENTER the second time and
  466.                   you will exit this function.
  467.  
  468.             - D - This function allows finding an  attribute  and  changing
  469.                   the  character  within  an  area.   When  selected,   the
  470.                   Attribute chart is displayed  and  you  are  prompted  to
  471.                   place the cursor over the attribute  to  find  and  press
  472.                   ENTER.  Next the Character Chart is displayed and you are
  473.                   prompted to place the cursor over the character to change
  474.                   to and press ENTER.  Pressing ESC at any time  will  exit
  475.                   this function.
  476.  
  477.             - E - This function allows finding a character and changing the
  478.                   attribute within an area.  When selected,  the  character
  479.                   chart is displayed and you  are  prompted  to  place  the
  480.                   cursor over the find  character  and  press  ENTER.   The
  481.                   attribute chart is then displayed and you are prompted to
  482.                   place the cursor over the  attribute  to  change  to  and
  483.                   press  ENTER.   Press  ESC  at  any  time  to  exit.
  484.  
  485.                                     7
  486.  
  487.   Micro-Mapper  -- Copyright 1990 by Mark McDonald -- All Rights Reserved
  488.  
  489.  
  490.           - D Delete the area. Press D and you are prompted to  verify  the
  491.             deletion.  Press Y to delete the area, N or ESC to  not  delete
  492.             the area.  The area is filled with spaces.   The  attribute  of
  493.             the space is the same as the current screen attribute.
  494.  
  495.           - L Line Color change.  This function allows you  to  change  the
  496.             color of the semi-graphics characters(lines) within  the  area.
  497.             Press L and the Color Change window pops up.  Use this menu the
  498.             same as when changing the character colors.   Press  ENTER  and
  499.             the area is searched for any character between decimal 179  and
  500.             218.  If found, the color is changed to the selected color.
  501.  
  502.           - M Move the area.  After marking the area,  press  M.   You  are
  503.             prompted to position the  cursor  to  the  new  upper/left-hand
  504.             position of the area.  Press enter when you  have  located  the
  505.             position and the area is moved to the new location.  Note  that
  506.             the old position is filled with spaces using the current screen
  507.             attribute.
  508.  
  509.           - T Save as ANSI.  This function saves the marked area as a  ANSI
  510.             file(with color) called SA#.ANS.
  511.  
  512.           - R Replicate area.  This function allows you to  copy  a  marked
  513.             area to another location on  the  screen.   After  marking  the
  514.             area, press ENTER.  You are prompted to position the cursor  to
  515.             the copy location.  Press ENTER when positioned and the area is
  516.             copied.  Note that the attributes of the area are also copied.
  517.  
  518.           - S Save Area.  This function allows you to  mark  an  area,  and
  519.             save it  to  your  current  disk  as  an  ASCII   file   called
  520.             SA#.ASC.  This allows you to quickly create boxes with text and
  521.             include them in  your  code  using  your  favorite  programming
  522.             editor.
  523.  
  524.           - U Save area as MEM. The  name  of  the  file  is  SA#.MEM.  The
  525.             area is saved in a character attribute ...  format.
  526.  
  527.           - W Save area as Wild Cat 3 BBS format.  The name of the file  is
  528.             SA#.WC3.  This was  suggested  by  a  user  and  coded  to  her
  529.             specifications.
  530.  
  531.           Note: Each area file is saved with its own  extension.   MEM  for
  532.                 Memory, ASC for ASCII, WC3 for WildCat 3, and ANS for ANSI.
  533.                 Each area is saved as a unique file name  using  the  #  to
  534.                 make it so.  Up 999,999 files for each of the  three  types
  535.                 may be saved in any one directory.  Each SA file  is  saved
  536.                 in the current directory.  Each  SA  file  is  saved  as  a
  537.                 sequential file, each line of which corresponds to  a  line
  538.                 on the screen.  ANSI SA#.ANS files  may  be  typed  to  the
  539.                 screen as well as SA#.ASC files.  Don't type SA#.MEM  files
  540.                 to the screen as the results can be most annoying.
  541.  
  542.           - Zap attribute. This function  allows  you  to  increment(+)  or
  543.             decrement(-) the colors(attributes) in the area.  Press ESC  to
  544.             exit and restore the area to original attributes or press ENTER
  545.             to keep changes.
  546.  
  547.  
  548.  
  549.                                     8
  550.  
  551.   Micro-Mapper  -- Copyright 1990 by Mark McDonald -- All Rights Reserved
  552.  
  553.         * Block Char.  A very handy function  that  allows  you  to  create
  554.           large block letters, useful for titles, etc.  Press B, Enter  the
  555.           desired character (A-Z, 0-9, ?,/,!,:,-) and press enter.  You are
  556.           now asked to position the cursor to where you want the  character
  557.           printed.  The position is the upper-left hand corner of the block
  558.           character.  Remember to take this into account  when  positioning
  559.           the cursor.  If you change your mind, press ESC  before  pressing
  560.           ENTER.
  561.  
  562.           Three  block  character  sets  are  provided  with  Micro-Mapper.
  563.     
  564.           BLOCK.MCS contains the original set of large letters composed  of
  565.                     ASCII character 218.
  566.           WIRE.MCS  contains the same character set but is slightly smaller
  567.                     and is composed of double lines.
  568.           LLET.MCS  contains characters the same size as BLOCK.MCS but each
  569.                     letter is composed of  its  own  letter,  i.e.   the  A
  570.                     character is composed of capital A's.
  571.  
  572.           You may change from one character set to another by   using   the
  573.           Options function on the Main Menu.
  574.  
  575.           Each character set is an ASCII file that may be edited with  your
  576.           favorite editor.  You may also create and use your own  character
  577.           sets provided you follow these rules:
  578.  
  579.             1. The entire character set 0-9, A-Z, ?, /, !, :,  -,  must  be
  580.                represented or at the very  least,  a  hole  left  for  each
  581.                character in the file.
  582.  
  583.             2. The first line MUST contain a two digit number  representing
  584.                the width of each character, a space and a two digit  number
  585.                representing number of lines used to form each character.
  586.  
  587.             3. All characters must use the same number of lines or at least
  588.                that space reserved for each character is the same number of
  589.                lines.
  590.  
  591.             4. Each  line  must  be  terminated  with  a  asterisk  "*"  at
  592.                width + 1.  If your character set is 4 characters long,  the
  593.                asterisk will be in the fifth position.
  594.             5. The character set  file  must  be  a  standard  ASCII/MS-DOS
  595.                sequential file where each line is terminated by a  carriage
  596.                return and line feed character  (CHR$(13)  CHR$(10)).   Most
  597.                editors will put these characters on for you automatically.
  598.  
  599.             6. All the above rules MUST be adhered to or  the  Mapper  will
  600.                not read in your characters properly.  To get performance in
  601.                the character retrieval routines,  the  sequential  file  is
  602.                accessed randomly, calculating relative starting position of
  603.                each character based on the width and length defined in  the
  604.                first line and a number obtained from a list kept internally
  605.                defining the order of the characters.   Be  sure  that  your
  606.                characters are in the same order as found  in  the  provided
  607.                character sets.
  608.  
  609.           Note that you can use  Micro-Mapper  to  create  letters  out  of
  610.           graphics characters in  the  Draw  mode.   When  each  letter  is
  611.           finished, save it as an area and assemble the areas into  a  file
  612.  
  613.                                     9
  614.  
  615.   Micro-Mapper  -- Copyright 1990 by Mark McDonald -- All Rights Reserved
  616.  
  617.           using your programming editor.  All of the  character  sets  were
  618.           created with Micro-Mapper.
  619.  
  620.         * Chg  Color.  When this function is selected,  a  color  chart  is
  621.           displayed.  Place the cursor over the color/number and:
  622.  
  623.           - Pressing ENTER allows you to start drawing or typing characters
  624.             using that color.
  625.  
  626.           - A Alter. This handy function allows you to change the attribute
  627.             of each character on the screen.   The  characters  remain  the
  628.             same, only the color is changed.  Both characters and lines are
  629.             changed.
  630.  
  631.           - L Line allows you  to  change  the  color  of  all  single  and
  632.             double lines on the  screen.   Only  the  line  characters  are
  633.             changed.
  634.  
  635.           - ESC .  This function allows you to change your mind and restore
  636.             the current screen attribute to its original value.
  637.  
  638.           - U Use. Picks up the attribute at the  current  cursor  location
  639.             and sets the screen attribute to that color.
  640.  
  641.         * Draw allows you to draw single/double line  boxes  and  repeating
  642.           characters to accent your screen.   After  pressing  D,  use  the
  643.           arrow keys to draw.  Note that if you have a mouse installed, you
  644.           may use the mouse to position the cursor WITHOUT drawing.   While
  645.           in the draw mode, pressing ESC will bring up  the  draw  menu  or
  646.           you may select a draw function by pressing;
  647.  
  648.           - A use Attribute. Changes drawing color  to  be  same  as  under
  649.             cursor.  Position the cursor over the color you wish to use and
  650.             press A.
  651.  
  652.           - C Color Change. A color chart will be displayed.  Position  the
  653.             cursor over the desired  color/number  and  press  ENTER.   All
  654.             subsequent drawing will use that color/number.
  655.  
  656.           - D Double Line.  Press D to toggle to the double line mode.
  657.  
  658.           - S Single Line.  Press S to toggle to single line mode.
  659.  
  660.           - R Repeat Char.  Press R  to  enter  repeating  character  mode.
  661.             An ASCII chart  is  displayed.   If  this  is  the  fist  time,
  662.             position the cursor over the desired character and press ENTER.
  663.             If a character had already been specified, just press ENTER  to
  664.             continue to use it.
  665.  
  666.           - T Text.  Press T to exit the drawing  function  and  return  to
  667.             Text mode.
  668.  
  669.           - U Use Character. Changes draw character to one under cursor.
  670.  
  671.           - +- Increment/Decrement drawing color by 1.
  672.  
  673.           - */ Increment/Decrement drawing color by 16.
  674.  
  675.  
  676.  
  677.                                     10
  678.  
  679.   Micro-Mapper  -- Copyright 1990 by Mark McDonald -- All Rights Reserved
  680.  
  681.         * E  Eraser  -  Allows  you  to  erase  the  foreground  character.
  682.           Pressing ESC or M will display the  sub-menu  for  this  function
  683.           though you may just press the letter of the  command  desired  to
  684.           save time.  Press T to return to Text Mode.
  685.  
  686.           - A - Use the attribute under the current  cursor  position  when
  687.                 erasing.
  688.  
  689.           - B - Changes erase color to white on black.
  690.  
  691.           - C - Change the erase color(works the same as draw mode).  Press
  692.                 ESC to not choose a color.
  693.  
  694.           - K - Keeps attribute of character when erasing.  The erase color
  695.                 will change as the color  of  the  character  being  erased
  696.                 changes.  NOTE!  often the background color  is  completely
  697.                 obscured by the foreground color and character.   Sometimes
  698.                 this function will not return the color you think it should
  699.                 though it is working correctly.
  700.  
  701.           - T - Return to Text Mode. The current erase color is  saved  and
  702.                 the current screen color is returned to its value prior  to
  703.                 execution of the erase function.
  704.  
  705.           - +- - Increment/Decrement erase color by 1.
  706.  
  707.           - */ - Increment/Decrement erase color by 16.
  708.  
  709.         * F Find/Change an Attribute or Character within the area.
  710.  
  711.           - A - This function allows you  to  change  a  color  to  another
  712.                 color.  This is different from the Color Change  option  in
  713.                 that only the FROM color is changed.  When this function is
  714.                 selected, a color chart is displayed and you  are  prompted
  715.                 to position the cursor over the color/number that you  wish
  716.                 to change FROM and press  ENTER.   Now  you  are  asked  to
  717.                 position the cursor over  the  TO  color/number  and  again
  718.                 press ENTER.  All of the matching from colors in  the  area
  719.                 are now changed to the TO color.  Note that you  may  press
  720.                 ESC prior to pressing ENTER the second time  and  you  will
  721.                 exit the area function.
  722.  
  723.           - C - This function allows changing a character to another within
  724.                 the area.  When selected, an ASCII chart is  displayed  and
  725.                 you  are  prompted  to  place  the  cursor  over  the  FROM
  726.                 character and press ENTER.  Next you are asked to place the
  727.                 cursor over the TO character and again  press  ENTER.   All
  728.                 characters in the area  matching  the  FROM  character  are
  729.                 changed to the TO character.  Note that you may  press  ESC
  730.                 prior to pressing ENTER the second time and you  will  exit
  731.                 this function.
  732.  
  733.           - D - This function allows finding an attribute and changing  the
  734.                 character within an area.   When  selected,  the  Attribute
  735.                 chart is displayed and you are prompted to place the cursor
  736.                 over the attribute to  FIND  and  press  ENTER.   Next  the
  737.                 Character Chart is displayed and you are prompted to  place
  738.                 the cursor over the character to change TO and press ENTER.
  739.                 Pressing ESC at any time will exit this function.
  740.  
  741.                                     11
  742.  
  743.   Micro-Mapper  -- Copyright 1990 by Mark McDonald -- All Rights Reserved
  744.  
  745.  
  746.           - E - This function allows finding a character and  changing  the
  747.                 attribute within an area.   When  selected,  the  character
  748.                 chart is displayed and you are prompted to place the cursor
  749.                 over the FIND character and  press  ENTER.   The  attribute
  750.                 chart is then displayed and you are prompted to  place  the
  751.                 cursor over the attribute to change  TO  and  press  ENTER.
  752.                 Press ESC at any time to exit this function.
  753.  
  754.         * G Get Area. This function allows you to  get  an  area  that  was
  755.           previously saved.  All  formats  are  valid  though  MEM  is  the
  756.           recommend save/get format for an area.  Use of the  Get  function
  757.           requires that the DASCII, DANSI, DMEM, DWCAT3 programs be in  the
  758.           DOS path to be able to load your saved area.   Select  G  at  the
  759.           Main Menu.  You are prompted to position the cursor to the column
  760.           and row that you want the area to start at.  Pressing enter  will
  761.           display format selection menu.  Press the letter of  your  choice
  762.           or press ESC to return  to  the  screen  editor.   Now  the  file
  763.           directory is displayed  showing  all  the  files  that  have  the
  764.           appropriate .ext.  Enter the name of the file to  get  and  press
  765.           ENTER.  The area is now loaded.
  766.  
  767.         * I Info. Displays copyright info and author's address.
  768.  
  769.         * L Load.  Allows you to  load   a   previously   saved  map  or  a
  770.           screen capture(using CAPTURE.COM supplied with Micro-Mapper),  in
  771.           the  current  directory  or  DOS  PATH,  into  the  mapper.   The
  772.           following formats are supported;
  773.  
  774.           - ASCII.  The ascii format loads a screen  of  characters.   Each
  775.             line of  the  ascii  file(every  80  characters)  needs  to  be
  776.             terminated with a carriage return/line feed combination.   This
  777.             allows you to save an  entire  screen  and  reload  it  latter.
  778.             Remember, the colors are not loaded, only the characters.
  779.  
  780.           - C Com Generate.  This format is unique  as  it  allows  you  to
  781.             de-compile your generated screen programs(see  SAVE)  and  load
  782.             the screen characters and colors for further modification.
  783.  
  784.           - G General Ansi. This choice allows you to  load  an  ANSI  file
  785.             without having an Ansi driver loaded.  This is  NOT  foolproof.
  786.             There are MANY combinations of ANSI commands that may  be  used
  787.             in an ANSI file.  The only commands recognized  are  #J,  #;#m,
  788.             and #H.  If your screen is not properly  displayed,  load  your
  789.             ANSI device driver in  your  CONFIG.SYS   file,   re-boot   the
  790.             computer to install the driver and  use  option  A.   Save  the
  791.             screen in ANSI or other format.  From that point on, the mapper
  792.             will be able load the screen properly.  For  this  function  to
  793.             work   properly,   Micro-Mapper   must   be   able   to    find
  794.             DANSI.COM(supplied in the MAPPER zip file).  Make sure it is in
  795.             a directory mentioned in your DOS path.
  796.  
  797.           - M Memory.   This  format  loads  a  map  in  a  character  then
  798.             attribute  format.   Screen   captured   using   the   supplied
  799.             Micro-Mapper TSR, CAPTURE.COM are saved in this format.  It  is
  800.             the most compact format of them all.
  801.  
  802.           - N ANSI. Loads  an  ANSI  screen,  complete  with  colors.  This
  803.             function requires that your ANSI device driver be installed.
  804.  
  805.                                     12
  806.  
  807.   Micro-Mapper  -- Copyright 1990 by Mark McDonald -- All Rights Reserved
  808.  
  809.  
  810.           - W Wild Cat 3 BBS format.  Loads the new WC3 format.
  811.  
  812.           After choosing one of the above formats, the  screen  will  clear
  813.           and a list of possible files are displayed.   Enter  the  desired
  814.           file name and press enter.
  815.  
  816.           NOTE: If you specify a file that is not loadable by  the  Mapper,
  817.                 it will still attempt to  load  it.   This  may  cause  the
  818.                 screen to look pretty strange.  If this occurs, use the NEW
  819.                 function under the Main Menu to clear the screen and  start
  820.                 over.
  821.  
  822.         * Map Field. This function allows you to specify field  definitions
  823.           for a location on your map.  When  at  the  Main  Menu  press  M.
  824.           Micro-Mapper  will  look  in  the  current  directory   to   find
  825.           filespec.DEF  where  filespec  is  the  name  of  your  map.   If
  826.           filespec.DEF is NOT found, one is created.   If  filespec.DEF  is
  827.           found, all of the defined locations  will  be  marked  with  a  
  828.           (decimal 16) character in the color defined for the field.   When
  829.           in the Mapping mode, pressing;
  830.  
  831.           - ENTER - will bring up the field definition box for that  screen
  832.                     location box  where  you  may  specify  the  C-Name  or
  833.                     comment field name, V-Name or Variable name(as used  in
  834.                     your code), type where  A=any  keyboardable  character,
  835.                     D=date characters(0-9/), I=inclusion List, L=alphabetic
  836.                     letters     only(A-Z,a-z),     N=numeric(0-9)     only,
  837.                     P=phone(0-9-()), S=lower  case  letters  returned(a-z),
  838.                     U=uppercase letters returned, T=time  characters(0-9:),
  839.                     length(0-999),  skip(Y/N)  and  Inclusion  List(up   to
  840.                     twenty characters).
  841.  
  842.                 Note that  entering  a  number  as  the  V-Name  will  tell
  843.                 Micro-Mapper and  Micro-Coder(a  code  generator  to  write
  844.                 input/output  code  and  available   only   to   registered
  845.                 Micro-Mapper users) that this field is an array field which
  846.                 will   allow   automatic   subscript   incrementing    when
  847.                 replicating a field.
  848.  
  849.                 Pressing ESC will exit the  field  definition  box  without
  850.                 saving the field definition to filespec.DEF.
  851.                 Use the up and down  arrows  to  move  from  one  field  to
  852.                 another.
  853.  
  854.                 Pressing ENTER on the  last  field  will  cause  the  field
  855.                 definitions to be saved to filespec.DEF.
  856.     
  857.                 Note that Micro-Mapper does not require you to  enter  only
  858.                 certain character in each  field.   Micro-Mapper  does  not
  859.                 check to see if the options choosen are  valid.   They  are
  860.                 only suggestions.
  861.  
  862.           - A - Allows you to change the current color to the  color  under
  863.                 the cursor.
  864.  
  865.           - C - Brings up the color change screen to allow color  selection
  866.                 from the color chart.
  867.  
  868.  
  869.                                     13
  870.  
  871.   Micro-Mapper  -- Copyright 1990 by Mark McDonald -- All Rights Reserved
  872.  
  873.           - D - Define field. Brings up the field definition box.
  874.  
  875.           - E - Erase a field.  Place the cursor over the field mark to  be
  876.                 deleted and press E.
  877.  
  878.           - M - Move a field.  Place the cursor over the field to move  and
  879.                 press M.  You are prompted to move the cursor  to  the  new
  880.                 field location and press ENTER.  Pressing  ESC  will  abort
  881.                 the move.
  882.                 Note: If the position  that  you  are  trying  to  move  to
  883.                 already contains a field mark, the move is aborted.  If you
  884.                 still want to move a field to that  position,  erase(option
  885.                 E) the field from the desired position first and then  move
  886.                 the new field to that position.
  887.  
  888.           - R - Replicate Last Field.   Use  this  function  to  "copy"  or
  889.                 replicate  a  field  definition  as  another  field.   This
  890.                 function will NOT work after you have erased a field or  if
  891.                 you have not looked at the definition (D) of a field or  if
  892.                 you try to replicate a field over one that already exists.
  893.  
  894.                 To replicate a field for the first time, place  the  cursor
  895.                 over the field  to  replicate  and  press  ENTER  and  then
  896.                 Escape(ESC).  Now place the cursor at  the  spot  that  you
  897.                 wish to "copy" to and press R.  The definition box will pop
  898.                 up and will contain the same data as defined for  the  last
  899.                 defined field.  Change the definition as needed  and  press
  900.                 ENTER.  Pressing ESC will abort the replication process.
  901.  
  902.                 If the field that you  are  replicating  is  a  subscripted
  903.                 field, where the V-NAME is a  number,  then  the  subscript
  904.                 will be incremented automatically for you.
  905.  
  906.                 Note that the held definition that is "copied" is  that  of
  907.                 the last defined field.  In  other  words,  if  you  define
  908.                 field  A  and  replicate  it  as  field  B  then  the  next
  909.                 replication will use the definition for B, etc.
  910.  
  911.           - T - Return to Text Mode.  When selected, the  field  marks  are
  912.                 removed and the screen is restored.
  913.  
  914.           - U - Use current color.  This option allows you  to  change  the
  915.                 color of a field.  Change the current color using the A, +,
  916.                 /, *, -, or C options, place the cursor over the field mark
  917.                 and press U.  The field mark will change to its  new  color
  918.                 and filespec.DEF will be updated.
  919.  
  920.            +-*/ Change current color(same as draw mode).
  921.  
  922.         * New.  Clears the screen and starts  the  mapper  all  over.   All
  923.           characters/attributes previously displayed are lost.
  924.  
  925.  
  926.         * O Options Edit.  When Micro-Mapper in invoked, it tries  to  find
  927.           and load the contents of  MAPPER.CFG.   This  file  contains  the
  928.           configuration info.  Using this  function,  you  may  change  the
  929.           configuration,   Reset   the   configuration   back    the    the
  930.           original(author set) values, Get the config  file,  or  Save  the
  931.           current configuration to be used at next start-up.
  932.  
  933.                                     14
  934.  
  935.   Micro-Mapper  -- Copyright 1990 by Mark McDonald -- All Rights Reserved
  936.  
  937.  
  938.           When this  option  is  chosen,  the  mapper  looks  for  the  MAP
  939.           "COLOR1.COM" and displays it.  You will see  the  familiar  color
  940.           chart along with instructions  and  information  on  the  current
  941.           settings.
  942.  
  943.           A - Allows you to specify the name of the large character  to  be
  944.               used when the block character function  is  selected.   Three
  945.               files are provided:  BLOCK.MCS, WIRE.MCS and  LLET.MCS.   You
  946.               may also specify your own.
  947.  
  948.           B - This option allows you to  specify  the  mouse  button  delay
  949.               value.  On my computer 300 seems to work fine.  If you have a
  950.               286 or faster processor,  you  will  want  to  increase  this
  951.               number  to  prevent  your  mouse  clicked   selections   from
  952.               occurring too fast.
  953.  
  954.           C - Allows you to specify color in which  the  cursor  and  mouse
  955.               information is displayed.  Place the cursor over the  desired
  956.               color/number on the color chart and press C.  You should  see
  957.               the change immediately.
  958.  
  959.           E - Changes the color of the Message.  Position the  cursor  over
  960.               the desired color/number and press E.
  961.  
  962.           F - Changes the color of the FOOTER line.  Place the cursor  over
  963.               the color/number and press F.
  964.  
  965.           G - Get the contents of the MAPPER.CFG file.
  966.  
  967.           K - Saves the current definitions the MAPPER.CFG file.
  968.  
  969.           M - Changes the color of the pop-up menus.  Place the cursor over
  970.               the desired color/number on the color chart and press M.
  971.  
  972.           R - Resets the definitions to those originally specified  by  the
  973.               author.
  974.  
  975.           S - Changes the Start Up screen color. Position the  cursor  over
  976.               the desired color/number and press S.
  977.  
  978.           Z - Changes the Zap Screen color.   Place  the  cursor  over  the
  979.               color/number and press Z.
  980.  
  981.           ESC - Press ESC or the left mouse  button  to  exit  the  editor.
  982.                 Note that any changes made are not saved to the  MAPPER.CFG
  983.                 file but are used for the rest of the session.
  984.  
  985.           NOTE:  If the configuration screen just displays the numbers,  it
  986.           is because the mapper could not  find  COLOR1.COM  which  is  the
  987.           screen for the configuration editor.  Make sure that all  of  the
  988.           needed files are in a directory mentioned in your DOS PATH.
  989.  
  990.         * Print. Prints Screen to Printer.
  991.  
  992.         * Quit.  This function terminates Micro-Mapper.  It does  NOT  save
  993.           your work.  Be sure to  save  your  work  prior  to  leaving  the
  994.           mapper.
  995.  
  996.  
  997.                                     15
  998.  
  999.   Micro-Mapper  -- Copyright 1990 by Mark McDonald -- All Rights Reserved
  1000.  
  1001.         * Save.  This function allows you to  save  your  map  in,  in  the
  1002.           current directory, one of the following formats;
  1003.   
  1004.           - ASCII.   Saving  your  map  in  this  format  saves  just   the
  1005.             characters and lines.  The colors are not  saved.  The  map  is
  1006.             saved in 80 character lines with each line  terminated  in  the
  1007.             MSDOS standard of a carriage return and line feed  combination.
  1008.             A map saved in this format is easily loaded into your  favorite
  1009.             programming editor for inclusion into your source code.
  1010.  
  1011.           - Com Generate.  This format is special in that it creates a  COM
  1012.             program that can display your map  very  quickly  on  even  the
  1013.             slowest computers.  Both  the  characters  and  attributes  are
  1014.             displayed, just as you painted them.  There are  two  execution
  1015.             formats for the stand-alone map;
  1016.  
  1017.             Mapname - This causes your generated map to be displayed  until
  1018.             a key is pressed. At which time,  the  screen  is  cleared  and
  1019.             control is returned to DOS or the controlling  program.   Works
  1020.             ok for quick and dirty slide shows.
  1021.  
  1022.             Mapname /F - This displays your generated map  and  immediately
  1023.             returns  control  to  calling  program  or  DOS  level  without
  1024.             clearing the screen.  This allows you to  display  a  map  from
  1025.             within your program via the DOS SHELL command  common  to  most
  1026.             MSDOS supported languages.  Imagine, no more coding to  display
  1027.             a screen.  Just  paint  it  with  Micro-Mapper  and  have  your
  1028.             program display it.
  1029.  
  1030.             Example in your program, the command  SHELL  "MAPNAME/F"  would
  1031.             execute the generated map MAPNAME and return  control  to  your
  1032.             program.  For dBASE use: RUN MAPNAME.COM /F
  1033.  
  1034.           - Memory.  This format saves your map in  a  character  and  then
  1035.             attribute format.  Such a map could subsequently be loaded into
  1036.             your source code as data statements and displayed via a reading
  1037.             loop.  The total size of the  file  is  3840  characters,  1920
  1038.             characters and 1920 attributes.  Note this format is  sometimes
  1039.             referred to as a Binary format as it is a direct dump of  video
  1040.             memory to disk.  Each byte is an integer.
  1041.  
  1042.           - N ANSI. Saves the screen as  an  ANSI  screen.  This  does  NOT
  1043.             require that your ANSI device driver  be  installed(applies  to
  1044.             save only). IF your ANSI driver  is  installed,  use  the  TYPE
  1045.             command to view the map.  Screens saved in this format  may  be
  1046.             loaded using option G on the load  menu  -  without  having  an
  1047.             ANSI.SYS device driver loaded in CONFIG.SYS.
  1048.  
  1049.           - W Wild Cat 3 BBS format.
  1050.  
  1051.         * User. Allows you to call a program(BAT, EXE or COM) that you have
  1052.           written.  Such a function could be used to display a ANSI screen,
  1053.           and then call a routine that you have  written  that  would  then
  1054.           read the screen and develop a  screen  displayable  in  a  format
  1055.           peculiar to your  application.   Remember,  most  batch  programs
  1056.           write to the screen.  If you desire to use  a  batch  program  to
  1057.           issue  various  commands  without  clearing  the  screen,  it  is
  1058.           recommended that you compile  the  BAT  file  using  one  of  the
  1059.           sharware batch compilers available on  most  boards.   This  will
  1060.  
  1061.                                     16
  1062.  
  1063.   Micro-Mapper  -- Copyright 1990 by Mark McDonald -- All Rights Reserved
  1064.  
  1065.           prevent the commands from being displayed and also  prevent  user
  1066.           tampering should you decide to distribute the batch file.
  1067.  
  1068.         * Window.  This function allows you to open a window to DOS.   Note
  1069.           that enough memory must be  available  or  the  results  will  be
  1070.           unpredictable.  Most of the time  the  function  will  refuse  to
  1071.           operate.   If  you  have  a  384k  or  larger  memory   and   the
  1072.           Micro-Mapper is at the 1st level, there will  be  enough  memory.
  1073.           If you have  called  Micro-Mapper from  within  your  programming
  1074.           editor, there may not be enough memory.  Be careful!   Experiment
  1075.           before putting any work to risk.  At least 17k of free memory  is
  1076.           need to open a window to DOS.
  1077.  
  1078.         * XChart.  This function  is  available  to  assist  with  entering
  1079.           non-keyable  characters.   When  this  function  is  selected,  a
  1080.           ASCII chart containing all 256 character is displayed.  Place the
  1081.           cursor over the desired character, press ENTER and the  character
  1082.           is placed on the screen.  You may also use the ALT NUM  to  enter
  1083.           such characters.
  1084.  
  1085.         * Zap. This command allows you to replace the current  contents  of
  1086.           the screen with a text pattern.  Select Z from the main menu  and
  1087.           the ASCII chart is  displayed.   Position  the  cursor  over  the
  1088.           desired character and press ENTER.  The screen  will  be  cleared
  1089.           and all positions will contain the zap character.
  1090.  
  1091.  
  1092.     Map Field record format:
  1093.  
  1094.     The filespec.DEF file created/updated by the Map Field function is   an
  1095.     ordinary ASCII(sequential) file,  each   record   terminated   with   a
  1096.     carriage-return and line-feed combination.
  1097.  
  1098.     Columns   - Purpose
  1099.     --------    -------
  1100.       1 - 6     Cursor Column,Row
  1101.       7 - 11    Foreground, Background color numbers
  1102.      12 - 14    Decimal Color Attribute number
  1103.      15 - 23    ANSI Color Code Sequence
  1104.      24 - 32    Mouse Mickey Column, Row
  1105.      33 - 52    Comment
  1106.      53 - 72    Variable Name
  1107.      73 - 73    Field Type
  1108.      74 - 76    Field Length
  1109.      77 - 77    Skip to Next Field Indicator
  1110.      78 - 98    Inclusion List
  1111.      99 - 99    Logical End of Record Mark *
  1112.     100 - 100   Carriage Return (Decimal 13, Hex 0D)
  1113.     101 - 101   Line Feed (Decimal 10, Hex 0A)
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.                                     17
  1126.